getexecutionsremaining

SoftwareShield ClientProtector COM Component > ClientProtector (SSCProtector) Reference > GetExecutionsRemaining

## GetExecutionsRemaining

The GetExecutionsRemaining function retrieves the remaining executions of an expiring license which has an execution limit (if any).

###### Syntax

HRESULT GetExecutionsRemaining ( long * ExecutionsRemaining, VARIANT_BOOL * IsExpireType );

###### Parameters

ExecutionsRemaining

[OUT] This is (a pointer to) a numeric value which returns holding the number of remaining executions before the license will expire.

IsExpireType

[OUT] This is (a pointer to) a boolean value which returns holding a value indicating if the license is currently under the influence of an execution limit (which has been reached or not). Note that once you successfully use a Release All Expiration type of Activation Code on the license, that the license is no longer considered an expire type and this parameter returns false. Always ignore the other parameter if this parameter returns containing false.

###### Remarks

Note: This function is illustrated in the SoftwareShield Flowcharts - (see flow chart #3).

The GetExecutionsRemaining function retrieves the remaining executions of an expiring license which has an execution limit (if any). If the license is under the influence of an execution limit (which has been reached or not), the ExecutionsRemaining parameter will return holding the number of remaining executions before the license will expire.

If the license has no execution limit, the IsExpireType parameter will return holding false. If the license is under the influence of an execution limit, it will return holding true.

If you instead need to know the total number of permitted executions (ignoring how many may have been used) use: GetExecutionLimit. If you instead need to know how many executions have been used-up, use: GetExecutionCount.

###### Return Value

As with all COM function calls they return an HRESULT. HRESULT is a data type that is a 32-bit error or warning code. Check your compilers documentation for information on interpreting the HRESULT value.

###### Function Information

Exposed By Interface: | "ISSCProtector"
Exposed In COM Server Binaries: | "SSCProt.dll" and "SSCProtD.dll"